home *** CD-ROM | disk | FTP | other *** search
/ The Games Room / The Games Room.iso / amiga / tetris&blocks / tetris_ik / tetris.doc < prev    next >
Text File  |  1992-03-06  |  16KB  |  474 lines

  1.                    Tetris v1.00 (C)1997 by Iain King
  2.                    =================================
  3.  
  4.   /===================================================\
  5.   |This is Shareware - see bottom section for details.|
  6.   \===================================================/
  7.  
  8. Why another version of Tetris?  Who knows.  I just wanted to see if I could
  9. make one, and also because I couldn't find a standard Tetris game.  I've got
  10. Tetris Pro, but it has silly power ups (though the music is cool).  So this
  11. is my attempt.
  12.  
  13.  
  14.    This Tetris is programmed in Blitz Basic 2, which was made by those cool
  15. dudes at Acid software.  Wahey!
  16.  
  17.  
  18.    This program was tested on an A1200, because surprisingly enough, thats
  19. what I've got.  It should run on any Amiga at full speed.  It might not on a
  20. 500/500+/600, but I can't test it so tough.  It should run fine, just maybe
  21. slower.  
  22.  
  23.    N.B. I haven't implemented any music, mainly because music in games is
  24. usually really annoying, and if you want to listen to music, you stick your
  25. Hi-Fi on.  If you want you can switch the sound fx off as well.  I've
  26. integrated Tetris' sound control with your Television/Speakers.  Simply turn
  27. the volume control on your respective device to 0 and the sound will stop
  28. itself until you turn the volume back up.
  29.  
  30.  
  31.    Feel free to send me your palette's/block designs - if they're any good
  32. (lets face it - they'll be better then mine) I'll put them in the next
  33. release.
  34.  
  35.  
  36. ============================================================================
  37.  
  38.    Contents
  39.  
  40.       First, a note on controls.
  41.  
  42.       How to play the thing
  43.  
  44.       The game of Tetris
  45.  
  46.       Then about the BlockDesign program
  47.  
  48.       Then about the Grabber program
  49.  
  50.       Then about the palette (changing it)
  51.  
  52.       Lastly some other stuff
  53.  
  54.          This is Giftware
  55.  
  56.          Files
  57.  
  58.          Bugs
  59.  
  60.          My addresses
  61.  
  62.  
  63. ============================================================================
  64.  
  65.    Controls.
  66.    --------
  67.       A joystick in port 1 (the joystick port) or the cursor keys may be
  68. used to control Tetris.
  69.  
  70.       In the menus <Fire> and <Return> activates.
  71.  
  72.       In game, <Fire>, <Up-Arrow> and <Right Shift> rotate the shape around
  73.       Left/Right move shape left/right
  74.       Down drops shape 
  75.  
  76. ============================================================================
  77.    How to play?
  78.    ------------
  79.        After double clicking on tetris, a screen should open up at a menu,
  80. showing you four options:
  81.  
  82.  
  83.       Start
  84.       -----
  85.  
  86.          Simple - starts the game
  87.  
  88.  
  89.       Normal
  90.       ------
  91.  
  92.          This is showing that the difficulty is set at 'normal'.
  93.          Hitting it will cycle it through 'normal' 'hard' and 'very hard'
  94.          difficulty settings.
  95.  
  96.          The difficulties work like this:
  97.  
  98.             'normal'       Go up a level every 20 lines
  99.             'hard'         Go up a level every 10 lines
  100.             'very hard'    Go up a level every 05 lines
  101.             'impossible'   Go up a level every 01 line
  102.  
  103.          Level ranges from 1 to 50, where fifty is ludicrously fast (block
  104.          goes down a row every 1/50th of a second)
  105.  
  106.          There is a seperate score table for each level.
  107.  
  108.       Colour
  109.       ------
  110.  
  111.       Hitting this toggles it between 'colour' and 'black'.
  112.       Switches the backdrop colour.  'colour' generally looks nicer, but
  113. 'black' offers higher contrast (and maybe a smaller headache from watching
  114. the screen to long).
  115.  
  116.  
  117.       Quit
  118.       ----
  119.  
  120.       Saves high score table to current directory then quits
  121.  
  122.  
  123. ============================================================================
  124.  
  125.    The game of Tetris
  126.    ------------------
  127.  
  128.    Once you hit start you're into Tetris properly. I'll briefly sum up what
  129. it's about for both of you who don't know.
  130.  
  131.    A randomly determined block appears at the top of the screen ( you can
  132. see what the next block is in the view window to the top-left).  It will
  133. start moving downward, and you will be able to guide it left and right and
  134. rotate it. When the block reaches the bottom, or lands on top of another
  135. block, it will sit there and another block will appear at the top of the
  136. screen for you to control.  This goes on until the screen is filled at which
  137. point its game over.  BUT WAIT!  The whole point is, that if you manage to
  138. lay the blocks so that an entire row is filled (i.e. a horizontal row with
  139. no gaps), it will disappear, and all the blocks above it will fall down into
  140. the space.  So all you have to do is keep making lines to stay alive for as
  141. long as possible.  Sounds simple don't it? :)
  142.  
  143.    A couple of hints:
  144.  
  145.        1) If your block won't rotate, it's probably because there is
  146.           something next to it stopping it : move it away from any obstacles
  147.  
  148.        2) A block doesn't land the second it touches something below it - you
  149.           can still slide it for a couple of moments.
  150.  
  151.        3) because of 2, if you've left an overhang, you can slide a block
  152.           under it to fill the gap.
  153.  
  154.        4) The more lines you get at once, the more points you get for doing
  155.           it, and there is a special bonus for completely clearing the
  156.           screen.
  157.  
  158.  
  159. ============================================================================
  160.  
  161.  
  162.  
  163.    The BlockDesign program
  164.    -----------------------
  165.  
  166.  
  167.    Not everyone's tastes are the same (mine vary according to what day it is),
  168. so Tetris has an option that allows you to use a different set of blocks.
  169. The different sets of blocks are stored in the 'blocks/' sub directory,
  170. which should be in the same dir as the Tetris program.  BlockDesign should
  171. also be in the same dir as the Tetris program.  When you click on it it will
  172. pop up a file requester (in the blocks dir) asking you to select a blocks
  173. file.  It should contain (to start with) something like:
  174.  
  175.       checked
  176.       plain
  177.       square
  178.       torn
  179.       marble
  180.       stone
  181.  
  182.    These are the blocks supplied with Tetris
  183.  
  184.    Double clicking on one of these will copy it into the tetris.shapes file
  185. in the Tetris program directory, selecting the block set.*
  186.    If, in the blocks dir there is also a relevant palette file for the block
  187. file you selected, this will also be copied to the Tetris program dir.  I.E.
  188. if you select 'torn' and 'torn.pal' exists, then this will also be copied
  189.  
  190.    *.  If you want to have a smaller installation, simply delete the blocks
  191. directory and the BlockDesign program, making sure you have a valid
  192. tetris.shapes file in the tetris program directory (run Tetris - if it
  193. works, you've got the file).
  194.  
  195.    The BlockDesign program is not a necessary file for tetris to work (see
  196. bottom bit for a list of necessary files)
  197.  
  198. ============================================================================
  199.  
  200.    The Grabber program
  201.    -------------------
  202.  
  203.    You may be thinking: Having the BlockDesign thingy is all very nice, but
  204. all his blocks are shit, and you'd basically be right (I am *not* a very good
  205. artist), but cheer up - you can draw your own blocks to use.
  206.  
  207.    In the Tetris program directory there should be a 'gfx' dir containing a
  208. tetris.iff picture file.
  209.    This is a template, and what you should use to draw your own blocks.
  210. (It is actually the picture file that the 'plain' block set was grabbed off
  211. of).
  212.  
  213.    To create your own blocks, simply do this:
  214.  
  215.    1)   Load up DPaint (or whatever you use), with a screen format of
  216. 320x256x16 colours.
  217.  
  218.          The colours work like this:
  219.  
  220.             0     Background
  221.             1     Block Shadows
  222.             2     Block Middle colour dark     (can really be anything)
  223.             3     Block Middle colour light    (ditto)
  224.             4     Block Highlight
  225.             6     Menu Text
  226.             7     Menu Shadow
  227.             8     Menu Highlight
  228.  
  229.        10-14      Use as you want
  230.  
  231.          The palette on the tetris.iff file should give you an idea.  See
  232. next section for more info on the palette.
  233.  
  234.    2)   Load up the tetris.iff file.  You should see collection of 3d blocks.
  235.  
  236.    3)   Draw your designs.  You should keep the same shape as the ones
  237. given, and its a good idea to keep the shapes with the 3d edges, as Tetris
  238. has some in built 3d stuff, and will act like the blocks are 3d even if they
  239. are not.
  240.  
  241.       *DO NOT MOVE THE BLOCKS ABOUT*
  242.       Grabber needs the blocks to be in the correct position, and each row
  243. must all have the same leading vertical position.  To avoid huge problems
  244. simply load tetris.iff and DO NOT MOVE THE BLOCKS - draw inside them.
  245.  
  246.       The easiest way to do this is to draw your design on the first block
  247. of each set, then using brush and rotate functions, paste it over the rest.
  248. It is possible to use the same brush for all the L shapes, ditto for the S
  249. shapes, by using the mirror function.
  250.  
  251.       Once you've done that, switch to a reserve screen and load up the
  252. gfx/borders.iff file.  This is all the outlines of the shapes.  Grab it as a
  253. brush, switch back to your picture, and paste it over your shapes - instant
  254. 3D!
  255.  
  256.    N.B. Blitz can't handle iff's that have been saved with a stencil, so
  257. don't.
  258.  
  259.    4)   Save your picture in the Tetris program dir, as something like
  260.               'myblocks.iff'
  261.  
  262.    5)   Run the Grabber program
  263.  
  264.    6)   In the first file requester select your picture file 'myblocks.iff'
  265.  
  266.    7)   In the second requester, it should automatically have opened into
  267.         your 'blocks' directory.  If not then find your blocks dir, then
  268.         type in a filename at the prompt : this will be what your block set
  269.         is called.
  270.  
  271.    8)   Grabber should load your picture, scan for the blocks, redisplay
  272.         them.  Once you hit the mouse, it will save them off to your chosen
  273.         filename, then clear the screen and reload them.  If they all appear
  274.         OK on the screen it should have worked.  Hit the mouse again to exit.
  275.  
  276.          N.B. grabber will also save your pictures palette to te relevant
  277.          palette file in the blocks dir
  278.  
  279.    9)   Run BlockDesigner, and double click on you block set
  280.  
  281.   10)   Run Tetris and start a game - you should have your only little set
  282.         off blocks. Aren't they nice?
  283.  
  284. ============================================================================
  285.  
  286.  
  287.        Changing the palette
  288.        --------------------
  289.  
  290.    The colour info for Tetris is kept in the 'tetris.pal' file in the Tetris
  291. program dir.  it looks like this:
  292.  
  293.          0     Background
  294.          1     Block Shadows
  295.          2     Block Middle colour dark
  296.          3     Block Middle colour light
  297.          4     Block Highlight
  298.          5     White
  299.          6     Menu Text
  300.          7     Menu Shadow
  301.          8     Menu Highlight
  302.          9     Menu Text Highlight
  303.          10    Null
  304.          11    Null
  305.          12    Null
  306.          13    Null
  307.          14    Null
  308.          15    Menu Background Highlight
  309.  
  310.    You cannot set colours 5,9,15 as they are reset by the program.  You can
  311. edit all the rest.  
  312.    You can do his easily enough - just load the palette file into DPaint (or
  313. whatever) and change the values, then save.
  314.    There is a file: 'palette.iff' that displays a menu and a block - handy
  315. for designing your palette.
  316.  
  317.    NOTE
  318.    ----
  319.  
  320.    Some (all) of the blocks in the blocks dir have .pal palette files.
  321. BlockDesign will copy these over onto tetris.pal as well as the actual shape
  322. file.  Either delete the block.pal files, or change them instead of the
  323. tetris.pal file, or keep a backup of your palette in the defaults directory.
  324.  
  325.    If you manage to loose your blocks/palette, the default ones are in the
  326. defaults directory - simply copy them across.
  327.  
  328.  
  329. ============================================================================
  330.  
  331.    Other stuff
  332.    -----------
  333.  
  334.       OK.  First, Tetris is Shareware.  If you play it a lot (which hopefully
  335. lots of you will), you should send be some money.  5 pounds sterling (8
  336. dollars I think) sounds about right to me for the phase reversal that
  337. resulted from writing this (I ended up awake/asleep in the wrong 12-hour
  338. cycle).  You can send the money to the address below.  Please support
  339. Shareware, as some people will stop writing cool stuff if you don't.
  340.  
  341.  
  342.    The files you have should be:
  343.  
  344.          Tetris
  345.          Tetris.info
  346.          Tetris.doc
  347.          Tetris.doc.info
  348.          BlockDesign
  349.          BlockDesign.info
  350.          Grabber
  351.          Grabber.info
  352.          tetris.shapes
  353.          chars.shapes
  354.          tetris.pal
  355.          sfx/
  356.             BassDrum2
  357.             Ohman
  358.             FallingPiano
  359.             thunder
  360.          defaults/
  361.             tetris.shapes
  362.             tetris.pal
  363.          gfx/
  364.             tetris.iff
  365.             palette.iff
  366.             borders.iff
  367.          blocks/
  368.             checks
  369.             checks.pal
  370.             plain
  371.             plain.pal
  372.             squares
  373.             squares.pal
  374.             torn
  375.             torn.pal
  376.             marble
  377.             marble.pal
  378.             stone
  379.             stone.pal
  380.  
  381.    If they aren't there then they SHOULD BE!
  382.  
  383.  
  384.  
  385.    Here is a list of the files that Tetris *needs* to run
  386.  
  387.       Tetris
  388.       tetris.pal
  389.       tetris.shapes
  390.       char.shapes
  391.       sfx/
  392.          BassDrum2
  393.          Ohman
  394.          FallingPiano
  395.          thunder
  396.  
  397.    Of course, I wouldn't recommend deleting the docs or the icon for Tetris.
  398.  
  399.  
  400.  
  401.    A list of credits here:
  402.    -----------------------
  403.  
  404. Programming and graphics were all done by me: Iain King
  405.  
  406. The 'Torn' block design was based on the blocks in Tetris Pro, done by: Art
  407.  
  408. The marbling texture for the 'marble' blocks was off: the A on the AF
  409.                                                       Photogenics coverdisk
  410.                                                       (so thanks to Amiga
  411.                                                                     Format)
  412.  
  413. Ohman taken from MotherLode, which was written by: Some cool bloke (I can't
  414.                                                    find the disk - sorry)
  415.  
  416. Thunder taken from 'The Dark', a totally excelent mod by Nico Arianoutsos
  417.  
  418.  
  419.  
  420.  
  421.    Bugs
  422.    ----
  423.  
  424.    There is a bug with the keyboard - it occasionally locks up.  I'm 99%
  425. sure that this is Blitz's fault and not mine, so don't bother telling me
  426. about this one.  If it severely annoys you then
  427.       a) pretend its a random difficulty enhancer, or
  428.       b) use the (eurch) joystick
  429.  
  430.    Grabber has some strange little bug in it.  The shapes generated will
  431. still work, but during play you might notice gaps between blocks on the
  432. horizontal connection (one block atop another).  Haven't got a clue whats
  433. doing it, probably the fact that Grabber is just a flung together morph of
  434. an earlier grabber I had made to catch sprites for a different game.  If
  435. your desparate, you can either (if there good blocks) send the piccy of them
  436. to me, or get a hold of the Blitz Basic 'shapesmaker'.  Blitz has been
  437. released a couple of times on Amiga Format in a run-only version (no
  438. creating executables), but all that you would need is the program in the
  439. tools drawer called 'shapesmaker'.  You might look for a back issue.  You
  440. could also look on the 'net.  Obviously I can't include someone else's
  441. commercial program here, but other people might have.
  442.    Remember and save the palette if your doing it this way.
  443.  
  444.    I get really happy if people report bugs to me, so please do.
  445.  
  446.  
  447.  
  448.    My address
  449.    ----------
  450.  
  451.  
  452.    I can be reached through lots of places (2 at least):
  453.  
  454.    If your sending stuff, then this is the address:
  455.  
  456.  
  457.             Blairs Croft
  458.             Creetown
  459.             Newton Stewart
  460.             Scotland
  461.             DG8 7DF
  462.  
  463.    Bugs reports can go there too, but more preferable is my email address,
  464. which is:
  465.  
  466.       iking@cs.strath.ac.uk
  467.  
  468.    And if you want you can check out my web site (it's got some other Amiga
  469. stuff I made on it) at:
  470.  
  471.       http://www.strath.ac.uk/~aeu95140/
  472.  
  473.    Have fun!
  474.